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1.0 NELS Version 1.2 Database Schema 


1 .1 Schema Introduction 

The following section discusses the database tables used by NELS version 1 2 To 
provide the current functional capability offered by NELS. nineteen (19) tables have 
been created with ORACLE. Each table lists the ORACLE table name and provides 
brief description of the tables intended use or function. The following sections 

S four ^' C 1 C o ate 9 0ries of table s= NELS object classes. NELS collects NELS 
objects, and NELS supplemental tables. Alsp included in each section is a definition 
and/or relationship of each field to other fields or tables. The pZary wTto 

3E ^dou^'astelSIs r^hfn' 6 as 'TV?' While ,orei9 " keys are I"*** 

r„,r astensks ( ). The primary key s indicate the key(s) which uniauelv 
denudes a record for that table. The foreign key(s) is used to identify adSiS 
information in other table(s) for that record. uenriry aaaitionai 

tabteMor^R S di A e n ar V h « command which are used to construct the ORACLE 
Lre de fned^n S the COnta,ns lhe commands which create the tables which 

butld^^dices^o/the^'tabf^* 1005 ApP “ dlX B C ° n ' ainS ,ha “ mma " ds which 


1-2 NELS Object Classes 

The tables listed in Table 1 . 2-1 NELS Object Classes, provide the necessary 

dew a ,H° n tddd,in t ob i ect classes ' These object classes are used by librarians to 
define the objects that are entered into the library. The followinq sections are an 

ob P eactes n se 0 s ,eaCh ‘ ab ' e ^ ' h8ir associaled ,ields which are osed to define these 



Table Name 

Description 

ObjectClasses 

Provides a list of all the known object classes that 
are defined in the library. 

ClassFields 

A subordinate table to ObjectClasses. It contains 
information about the attributes which describe the 
object. 

EnumTypes 

A subordinate table to ClassFields. It provides a list 
of all the known enumeration types. 

EnumValues 

A subordinate table to Enum Types. It contains the 
enumerated values for each enumeration type. 


Table 1.2-1 NELS Object Classes 


The 'ObjectClasses ' table is the highest level table in defining the object classes for 
objects. By using this table, one can construct a data structure which provides the 
details about each attribute used to define the metadata about an object. 

1.2.1 ObiectClasses Table 

The first table listed in Table 1.2-1, contains a list of every object class that will or 
has been created by a librarian. Normally, the Head Librarian will create all the 
object classes that will be used for the NELS library. The object class table consist 
of three fields. These fields are shown in Table 1 .2-2 ObjectClasses Fields. 


Field Name 

Format 

Length 

ClassID 

Character 

22 

ClassName 

Character 

80 

NumFields 

Number 

38 

Table 1.2-2 ObjectClasses Fields 


The 'ClassID' field is the key field used to access the attribute fields in the 
classfields table. This value is entered into the Class_!D field of objects to indicate 
what class object NELS is processing. Inheritance from base class objects is 
determined by this value. For example, the object class having a ClassID of 
'1002004' would inherit field attributes from the 'I' Generic object class, the '1002' 
object class, and the '1002004' object class. 

The 'ClassName' field is a character string which represents the name of this object 
class. 

The 'NumFields' field contains the number of field attributes associated with this 
object class. This is a total of all fields, including those field attributes that are 
inherited from the base object class. 
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1.2.2 ClassFields Table 


Table 1.2-3 shows the fields that make up an object class. These fields describe 
the information necessary for NELS to accept inputs or display output for the field 
attribute associated with this object class. 


Field tyame 

Format 

Length 

CiassID 

Character 

22 

Name 

Character 

50 

Prompt 

Character 

50 

Kind 

Number 

38 

Visibility 

Number 

38 

Editable 

Number 

38 

Length 

Number 

38 

NumColumns 

Number 

38 

NumLines 

Number 

38 

FieldUnique 

Character 

1 

SeqNum .. 

Number 

38 

Enum ID 

Number 



Table 1.2-3 ClassFields Fields 


The 'ClassID' field , along with the name, is the primary key used to access the 
attribute fields. All records containing the same classic! are associated with the 
same object class. Multiple ClassID values, as described above are concatenated 
to produce the complete object class structure. For example, the object class 
having a ClassID of '1002004' would concatenate the field attributes from the classid 
T, '1002', and '1002004'. 

The 'Name' field contains field name in the objects table that is used to store values 
for this attribute. For example, the ’title' field in the objects table would contain the 
title of the object. 

The 'Prompt' field is the prompt that will be displayed for this attribute. This prompt 
will be displayed any time the metadata about an object is displayed or entered. 

The 'Kind' field is an integer value which equates to the data type of this attribute. 
The following values are used for this field to indicate the data format type selected. 




Data Type 

Character 
Enumeration 
List 

One to One 
One to Many 
Integer 
Float 
Date 
Long 

The 'Visibility' field is an integer value which represents whether or not this 
attribute s value is visible to the user. The following values indicate visibility. 

Value Visible 

0 No 

1 Yes 

The Editable field is an integer value which determines whether or not this attribute 
can be edited or modified. However, when the value or values associated with this 
field are for display purposes only, this field is set to 'No' by the program. 

Value Editable 

0 No 

1 Yes 

The Length' field is an integer value which represents the maximum number of 
character for this attribute. Certain data types have preset values and this field can 
not be set by the librarian. The length for each of the data types is defined below. 
Only the character and long fields allow the librarian to enter a length. 


Value 

0 

1 

2 

3 

4 

5 

6 

7 

8 


Data Type 

Length 

Character 

1 - 80 

Enumeration 

40 

List 

50 

One to One 

150 

One to Many 

150 

Integer 

10 

Float 

10 

Date 

10 

Long 

1 - 240 


The NumColumns' field is an integer value which represents the number of columns 

that are to be visually displayed. This value should be less than or equal to the 
'length' field value. 
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The 'NumLines' field is an integer value which represents the number of lines that 
are to be displayed for either character, long or list type fields. 

The 'FieldUnique' field is a character field which determines the input requirements 
for this attribute. The value indicates whether this attribute is Required (R), Not 
required (N), or Unique and required (U). If the field is required, then the user must 
enter a value for this attribute. If a 'U' is found in this field, the user must enter a 
value and that value must not exist in the library for this attribute. 

The 'SeqNum' field is an integer value which represent the order in which the field 
attributes are to be displayed. 

The 'Enum_ID' field is an integer value which identifies the enumeration type 
associated with this attribute. This field is only valid when the ’kind' field is set to a 
value of 1 for enumeration data types. This value is the key field into the 
'enum_types' and 'Enum_Values' tables which provide information about the 
enumeration type attributes. 

1.2.3 Enum Types Table 

The Enum_Types' table contains a list of all the enumeration types currently 
defined. Any of these enumeration types can be used to define attributes 
associated with any object class. Table 1 .2-4 Enum_types Fields lists the fields for 
this table. 


Field Ngme 

Format 

Length 

EnumJD 

Number 


Enum Type* 

Character 

40 

Table 1.2-4 EnumTypes Fields 


The 'Enum_ID' field is a unique integer value which identifies the enumeration type. 
This field is the key used to obtain the enumeration values for this enumeration 
type. 

The 'Enum_Type' field is a character field used to identify this enumeration type. 
For example, 'colors' would be the name entered for the enumeration type 
containing the colors (red, orange, yellow, green, blue, indigo, violet). 

1.2.4 Enum Values Table 

The Enum Values' table contains the actual enumerated values for each of the 
enumeration types defined in table 'Enum Types’. An entry is entered into this table 
for every value associated with the enumeration type. For example, the value 'red' 
would be one value entered for the enumeration type 'colors’ 


ORIGINAL PAGE IS 
OF POOR QUALITY 




Field Name 

Format 

Length 

EnumJD . 

Number 

SeqJMum 

Number 


Value 

Character 

40 


Table 1.2-5 Enum Values Fields 


The 'Enum_ID' field is an integer value which identifies the enumeration type. 
Multiple occurrences of this value form the basis of the enumerated values for the 
enumeration type. 

The 'Seci_Num' field indicates the sequence in which the enumerated value was 
entered. 

The 'Value' field is a character value which represents one of the occurrences of this 
enumeration type. 


1.3 NELS Collections 


The section will discuss the tables which are used by NELS to describe the various 
collections created by a librarian. Table 1.3-1 NELS Collections provides a brief 
summary of each table used to define a collection in the library. 


Table Name 

Description 

Librarians 

Provides information about the persons authorized 


to make any make changes to the library. 

Master 

Provides information about the collection. 


Table 1.3-1 NELS Collections 


1.3.1 Librarians Table 

The 'Librarians' table is included in this section because librarians are the only 
persons authorized to add, update, move, or delete collections in the library. This 
table plays an important role in determining who can add, update, modify, copy, 
move, and delete library components. These components are the object classes, 
collections, objects, and addition of other librarians. The object classes are required 
entries in an NELS library. Without object classes, no metadata about an object 
could be entered. Collections are also required. These collections are place- 
holders for objects. It is also a means of organizing objects into a common 
collection. Collection hierarchies can be built to model a domain. Once the object 
classes and collections have been created, the metadata about the objects can be 
entered into the library. From this metadata, users can search for objects of interest 
similar to browsing the local library. 


Field Name 


Format 


Le ngth 
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UserJD 
Collection! D 
Admin_Mask 
Custom Mask 


Character ~ 

Character 

Number 

Number 

Table 1.3-2 Librarians Fields 


Ih 6 Vs f -J D ‘ ,ield !_ s . a user idenli,icalion st ""9 indicating that this user has certain 
administrative capabilities. w ld,n 

J rnf\J^° lleCtl0n wu' !' eld ' S the co,lection identifier which indicates the top-most 
collection in which these pnvileges are active. A user who has privileges at the 

specified collection, also has these same privileges at all sub-collections in this 

then Ihp y in T^’ ' f . th , is user has been 9' ven other privileges at a sub-collection 
* h the lower level privileges are enforced .when the user traverses the hierarchy 

Th ' S meanS th3t 3 librarian can give a user all privileges at a high 
level, but take these pnvileges away at an sub-collection in the hierarchy. 9 

til 6 ’y m j n - Mask ' field contains the administrative mask indicating the privileges 
the user has at or below the collection specified in subject id. 

, T hT ' Cus ‘ om - Mask ' ,ie| d contains the administrative mask indicating the privileges 
he user has at or below this collection specified in subject Jd. Initially, this mask is 

-nnrSTTh S 6 admir ’- mask - " the person defined by ’userjd' has been granted 
chanoe , S P m 'teges the user can enter the Update Librarian menu and 
change or customize his pnvileges. The user can only add or delete privileges 
given at creation. Privileges not granted can not be altered. 


liftoff!,. ab ' e con,a " hS he information about an NELS collection, A collection is 
“ a c ° n,ainer or a folder. This folder can hold different classes of objects 
and other collections (normally called sub-collections). Following is Table 1 3 3 
Master Fields, which contains the fields used to describi a collection. 
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Field Name 

Format 

Length 

Collect ionJD 

Character 

22 

Collect ionName 

Character 

35 

Description 

Character 

240 

Related_Count 

Number 


Node_Type 

Character 

40 

Password 

Character 

8 

Total_Objects 

Number 


Num_Production 

Number 


Num_Developmental 

Number 


NumSecure 

Number 


Num_Archive_Production 

Number 


Num Archive Developmental 

Number 


Num Archive Secure 

Number 



Table 1.3-3 Master Fields 


The 'CollectionJD' field is the collection identifier of a collection. The highest level 
collection identifier is 'S'. All other collections are subordinate to this collection. 
Each subordinate collection is indicated by one character. For example, 'S2' would 
indicate the second subordinate collection under collection 'S’. Subordinate 
collections are labeled from 1 - 9, then from A through Z. A maximum of 35 
subordinate collections can exist for each collection. 

The 'Co!lection_Name' field is the collection name given to the collection. This is the 
name that will appear on any collection lists. 

The 'Description' fie Id is a brief description of the collection. 

The 'Related_Count' field is the number of related collections which contain similar 

or related information to this collection. The Collection ID value(s) entered for this 

collection are entered into the Links table and the number of collection links is 
entered into this field. 

The 'Node_Type' field is an enumerated type field. Legal values are "production", 
^developmental", "secure", "archive production”, "archive developmental", and 
"archive secure". Normal users will only see objects that are of type production. 
Librarians will be able to see all objects. 

The 'Password' field is reserved for future use with secure type collections. 

The Total_Objects‘ field contains the total number of "production" objects at this 
level and all levels (sub-collections) below this level. 

The 'Num_Production‘ field contains a count of all the objects in this collection which 
are of node_type "production". 

The 'Num_Developmental' field contains a count of all the objects in this collection 
which are of node_type "developmental”. 
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The 'Num_ Secure 'field contains a count of all the objects in this collection which are 
of node_type "secure". 

The 'Num_Archive_Production' field contains a count of all the objects in this 
collection which are of node_type "archive production". 

The 'Num_Archive_Developmental' field contains a count of all the objects in this 
collection which are of node_type "archive developmental". 

The ‘Num_Archive_Secure‘ field contains a count of all the objects in this collection 
which are of node_type "archive secure". 


1.4 NELS Objects 


Table Name 

Description 

Objects 

This table contains most of the metadata about 
each object and each tool in the library. 

Abstracts 

A subordinate table to Objects. It contains the 
value(s) which make up the abstract/description 
of the object. 

Authors 

A subordinate table to Objects. It contains the 
value(s) for the list of authors of an object. 

Keywords 

A subordinate table to Objects. It contains the 
subject terms/keywords associated with the object 
at each collection the object exists. 

Links 

A subordinate table to Objects. It contains the 

value(s) for a user-defined ‘one-to-one* and ’one-to-many* link 

data type. 

Long_Enum 

A subordinate table to Objects. It contains the 
value for user-defined ‘long* data type. 

Preabstracts 

A subordinate table to Objects. It contains the 
pre-processed abstract of the object. 


Table 1.4-1 NELS Objects 


1.4.1 Objects Table 

A total of seven ORACLE tables are used to fully describe the metadata for an 
object entered into the NELS library. The primary table which contains a majority of 
the metadata is the ’objects’ table. Table 1.4-2 Objects Fields defines the items 
which comprise this table. This table contains the most of the metadata about an 
object or a tool. Each object is represented by a single row (record) in the objects 
table. 




Field Name 

Collect ionJD 

Objectjd 

ClassJD 

Host_Name 

Format 

ObjedName 

PathName 

Version 

Lib_Entry_Date 

Last_Modified 

Flags 

Node_Type 
Title 
field9 
fieldl 0 

field50 


Format 

Character 

Number 

Character 

Character 

Character 

Character 

Character 

Character 

Date 

Date 

Number 

Character 

Character 

Character 

Character 

Character 


Length 

22 

22 
80 
40 
80 
240 
40 


40 

80 

80 

80 

80 


Table 1.4-2 Objects Fields 


JnH ^ lle w tl0 ?~!Fr f ,5 ld iS the collection in which this objects is defined. This field 
and the objectjd field uniquely identifies the object. 

The 'Object JD' field is an internally generated value which is used by NELS to 

uniquely identify the object. y 

The 'ClassJD' field indicates the object class of the object. 

'f d identi,ieS ,he host com P u,er on whi <* object resides 
This field will be implemented in a later version. 

The 'Format' field determines the objects format. For example havina ASCII as a 
ormat value would mean that the object defined by this metadata is ASCII format 
andean be viewed by an ASCII viewer. 

iltformafen""" 3 ™’ ^ USed by ,he USer ,0 supply addltonal object 

Th e ■PathName' field contains the complete path name or location of the object 

le "of t m T IT T 3 7 " a® ° bject is on ‘ line ' else ,he ^ conskfered to 
be off line. This location is used to view, copy, or print the contents of the object. 

library^™ 0 "' ^ C ° n,ainS ' h6 V6rSi0n ° f ,he ob ' ect ,hal is bein 8 P'aced into the 

“ nlains lhe da,e in which lhe ob ' ecl was entered into the 
dat J Th s ,ield can not be altered by the user. It is determined by the system 
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The 'Last_Modified' field contains the date in which the object was last modified. 
This field can not be altered by the user. 

The 'Flags' field indicates which metadata fields in other tables have values. The 
flags field will be implemented in a later version. 

The 'Node_ Type 'field is an enumerated type field which indicates the node type of 
the object. Legal values are "production", "developmental”, "secure", "archive 
production", "archive developmental", and "archive secure". 

The 'Title ' field contains a title or brief information about the object. 

The 'field9' through 'field50' fields are generic character fields which are used to 
contain other user-defined metadata fields (attributes) about an object. The data 
type of each field is determined by its classid. If user-defined fields for an object 
class were defined, the information contained in the ObjectClasses, ClassFields, 
Enum_Types, and Enum_Values tables would describe the contents contained in 
one of these fields. 

1.4.2 Abstracts Table 

This table contains the abstract segments which describe the object or contents of 
an object. Multiple records with the same object_id can be entered to provide 
abstracts as large as 2400 characters. Table 1.4-3 Abstracts Fields defines the 
items which form this table. 


Field Name 

Format 

Length 

Collection JD* 

Character 

22 

Object JD 

Number 


Abstract 

Long 



Table 1.4-3 Abstracts Fields 


The 'Collection_ID' field identifies the collection in which the object exists. 

The 'Object_ID‘ field identifies the object. This is the key that associates the 
abstracts with an object. 

The 'Abstract' field contains the actual abstract information that was entered by the 
user for the object. The abstract is broken into 240 character segments and entered 
into this table. The sequence number (SeqNum) is incremented by 1 every time a 
new 240 character segment is required to contain the abstract. A maximum of 10 
segments may be entered into this table at this time 



1.4.3 Au thors TahlP 

wj th an object. Multiple records 

Ta b ,e ,4-4 Authors 


Field Name 

CollectionJD* 

ObjectJD 

Author 


Format 

Character 

Number 

Character 


Table 1.4-4 Authors Fields 


Length 

22 

240 


The 'CollectionJD' field identifies the collection in which the object exists. 

w!ih a^tje-cf ' ield Wen,i ' ieS ' he ° bieCt ' This is ,he that associates the authors 

for any ob^cf be entered 

1AA Keywords TahlA 

lotrr iiK^ as ob°s e ; ?o with d z ob ’ ea - a 

can be entered to provide a seoarate ct Pt n ?5 1 tJ D , " d dlfferent CollectionjDs 

different collection S P Table 1 4-5 P Kevwordl J ° r the Same ° b J ect ID in 

table. - 4 5 Keywords F 'elds def.nes the items which form this 


Field Name 

CollectionJD 
Object ID 
Keyword* 


Format 

Character 

Number 

Character 


Length 

22 


Table 1.4-5 Keywords Fie'ds 


35 


The ■CollectionJD' field -dentifies the collection in which this object exists. 

The ObjectJD ' field identifies the object. This is the kev th^t 

keyword with an object and a collection. y 3 associates the 

The 'Keyword' field contains the keyword entered for this object in this collection 

T4 ,5 Links TahlP 

an f one -to-many) to other o bl ec,s 
Multiple records with the same Object ID ra 6 re ated col,ec hon for collections. 

number of links. Table 1 4-6 Links Field"*; r) P f ° f entered t0 P rovide an unlimited 

.4 b Links Fields defines the items which form this table. 
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Field Name 

Format 

Length 

CollectionJD 

Character 

. 22 

ObjectJD 

Number 


Name* 

Character 

50 

Link_Collection* 

Character 

22 

Link Object* 

Character 

15 


Table 1.4-6 Links Fields 


The CollectionJD' field identifies the collection associated with this link. 

The 'Object_ID‘ field identifies the object. For object links, this is the ObjectJD of 
the object that contains a link to another object. For related collection links, this 
value is zero (0). 

The 'Name' field contains the database field name defined as a one-to-one or one- 
to-many link field attribute. 

The 'Link_Collection' field contains a CollectionJD value of the collection being 
linked. 

The 'Link_Object' field contains an ObjectJD value of the object being linked. 

1.4.6 Long Enum Table 

This table contains values of attributes which have been defined as a long data 
type. A field name is also required to uniquely identify this attribute. Table 1 .4-7 
LongJEnum Fields defines the items which form this table. 


Field Name 

Format 

Length 

Collection^! D* 

Character 

22 

ObjectJD 

Number 


Name* 

Character 

50 

Abstract 

Character 

240 


Table 1.4-7 Long enum Fields 


The 'Collection_ID' field identifies the collection in which the object exists. 

The 'ObjectJD' field identifies the object. This key plus the 'name' value provide the 
key necessary to retrieve the long values for this object and field attribute. 

The 'Name' field contains the database field name defined as a long field attribute. 
This key plus the 'ObjectJD' value provide the key necessary to retrieve the long 
values for this object and field attribute. 

The 'Abstract' field contains the value of the long field. 


13 




L4.7 Preabstracts T^ hio 


a" 1 fSrrl'r ,he and 

form this table. ' able 1 .4-8 Preabstracts Fields defines the items which 


Field Name 

Collect ionJD 

ObjectJD 

Keywords* 


Format 

Character 

Number 

Character 


Table 1.4-8 Preabstracts Fields 


Length 

22 

80 


The ■Collection JD ^ ield identifies the collection in which this object exists. 
JroceS^^ ** is necessatv to retheve the pre- 

natural language's^a^feature o^^LS^This^a^D 0 ^ ’^d™" b ® USed by ,he 

keywords, and abstract fields of the object’. processed version of the title, 


1 -5 NELS Supplemental Tables 


Table Name 

AdminJOefs 

Applications 


AppFormats 

History 

Notify 

Output Queue 


Description 

Contains pre-defined librarian classes and the 
privileges associated with this class. 

(Tom frCf-alT 3 !' 0 " r .° 9arding a PPfcat*ons ihal can be run 
outpu. rec vests menU ' “ Sed “ ^ Vie “ e ' s - a " d «” 

daSSe 31 App™a,!o °s7able n h*" 31 "'" 0 “ ' he apP "“ fons 

Contains audit information about NELS usaqe 
Contes information about messages sent to users 

Contains queued output requests which are processed iust 
- P.rior to the user exiting NFI .9 processed just 


— * . 

Table 1.5-1 Supplemental Tables 


— A dmin Defs Tahfo 

This table is a supplemental table used by NELS This t^hi^ ™ * 

defined librarian classes Thic i ; 0 + ^ table contains a list of ore- 

for different types o ib ariln ind j ? 8 ' e h6ad Bbrarian 10 P^<Jefine privileges 

librarian class Table ,52 Admits d** T** P ™ ,eges ,0 a P^etmed 
Admin defs table Admm^defs describes the items which form the 
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Field. Name 

Name 
Mask 


Format 

Character 

Number 


Length 

35 

38 


Table 1.5-2 Admindefs Fields 


The 'Name' field contains the name assigned to the privileges for a specified 
librarian class. For example, "Head Librarian” would be a name of a librarian who 
has all administrative privileges assigned. This means that a librarian with these 
privileges could perform any of the administrative functions currently available in 

NELS. 

The 'Mask' field contains the preset privileges allowed for this type of librarian. A 
librarian with these privileges can only perform those functions that are determined 
by the value in the mask. 


1.5.2 Applications TablQ 


This table provides the necessary information required by NELS to build a command 
that will execute the application. The application can be activated from the 
"Applications" menu if defined as an application. If the application is defined as an 
object viewer, the application will be activated when an object of the format specified 
for the application is selected for viewing in the "Object Browser" window. If the 
application is an "output request" type application, the application is executed in the 
same manner as the object viewer. Table 1.5-3 Applications Fields describes the 
items which form this table. 


Field Name 

Name* 

Description 

AppType 

Process 

Path 

User Mode 
| Parameters 


Format 

Length 

Character 

40 

Character 

80 

Character 

20 

Character 

20 

Character 

80 

Character 

5 

Character 

240 


Table 1.5-3 Applications Fields 


The 'Name' field contains the application name that will be used to uniquely identify 
the application to execute. 

The 'Description' field contains a short description cf the application. 

7' he AppType' field identifies the type of application or intended use of the 
application. Legal selections are "application , viewer , archive , and output 
request" 

The 'Process' field identifies the processing for the application. The application is 
either processed "immediately" or is "queued" for later processing. 


13 



The 'Path ' field identifies the complete path name of the executable program. 

The 'User_Mode' field identifies the mode of operation of the application. The 
User_Mode selections are "X" if the application only runs under X windows, "ASCII" 
if the application only runs in character mode, or "Both" if the application can 
execute in either mode. 

The 'Parameters' field identifies any parameter(s) that is to be sent the the 
application defined. 

1.5.3 App Formats Table 

This table provides the formats that the applications defined in the Applications table 
can handle. The format entered for the application should be the word "all" or one 
of the format values listed in the add/update objects window. Table 1.5-4 
AppIFormats Fields describes the items which form this table. 


Field Name 

Format 

Length 

Name* 

Character 

40 

AppType 

Character 

20 

UserMode 

Character 

5 

Format 

Character 

40 


Table 1.5-4 App Formats Fields 


The 'Name' field contains the application name associated with the format entered. 

The ’AppType' field identifies the type of application or intended use of the 
application. Legal selections are "application", "viewer", "archive", and "output 
request". 

The 'User_Mode' field identifies the mode of operation of the application. The 
User_Mode selections are "X" if the application only runs under X windows, "ASCII" 
if the application only runs in character mode, or "Both” if the application can 
execute in either mode. 

The 'Format' field contains the format that the application can process. A value of 
"all" indicates that all object formats or files can be processed. 

1.5.4 History Table 

This table provides an audit trail of many of the actions perform against an object. 
Actions such as add, update, delete, viewing, copying, etc are recorded in this 
history file. Table 1 .5-5 History Fields describes the items which form this table. 


Field Name 

Format 

Length 

UserlD 

Character 

35 

Action 

Number 

3 

Acct Date 

Date 
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Collection! D 
Object ID 


Character 

Number 


22 


Table 1 .5-5 History Fields 


The 'Lfeer_/D'field identifies the user who performed the action. 

The 'Action' field describes the action which took place. Such as Copied or 
Browsed. 

The Acct_Date ' field contains the date and time the action took place. 

The 'Collection_ID' field identifies the collection upon which the action occurred. 

The 'Object_ID ‘ field identifies the object upon which the action occurred. 


1.5.5 Notify Table 

The notify table is a table used for passing messages from one user to another. 
This table is also used to notify users of changes to objects. Notification of changes 
to objects only occurs if the object was copied by the user. Table 1 .5-6 Notify Fields 
describes the items which form the notify table. 


Field Name 

UserlD 

ObjectJD 

Notifier 

New_Vers_ID 

Message 

RetainDate 

FromUser 

iTime 


Format 

Character 

Number 

Character 

Character 

Character 

Date 

Character 

Date 


Length 

35 

1 

40 

240 

35 


Table 1 .5-6 Notify Fields 


The 'User ID ' field identifies the user to whom the message is to be sent. 

The 'ObjectJD' field identifies the object, if any, associated with the message. This 
is used whenever a user wants to be notified of changes to an object. 

The 'Notifier' field identifies the type of notify message that to be sent. 

The 'New_Vers_ID' field contains the new version id of the object specified in the 
object Jd field above, if any. 

The 'Message' field contains the message to be sent to the user. 1 his message 
only applies to messages sent by another user. Messages related to changes 
associated with an object are formulated by the NELS program based on the value 

of notifier. 
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The 'RetainDate' field contains the last date that the message will be 
users. This field only applies to messages sent to all users. 


displayed to all 


2S ' Fr ° m - U f er ' field contains the user id of the person sending the message. This 

field only applies to messages sent from one user to another or from one user to all 
users. 


The Time field contains the date and time the message is sent. 

T5.-6 Output Queue Tahls 


The Output_Queue table is a table used to store the output request which was 

SeSS ' 0n - The 0utput request is P' aced int0 this table until the 
user exits NELS. Upon exiting, the use is given the option of cancelling the 

fromThP tTTriiV? 6515 3t thiS time ' The requests ar e then removed 
the output queue mble. 0ut P ut - Queue Fields describes the items which form 


Field Name 

UserlD* 

Directory 

Command 


Format 

Character 

Character 

Character 


Length 

35 

80 

240 


Table 1.5-7 Output_Queue Fields 


The 'UserJD ' field identifies the user requesting the delayed output request. 

The ‘Directory ' field contains the directory where the files for output can be found. 

tteVSp[It7^' 1 fest eld C ° ntainS aCtUal command ,hat is ,0 be issued 'o complete 


1.6 NELS Index Tables 

To provide more efficient retrieval of data, NELS uses index tables Table 1 6-1 
!hn eX ^ a " thG tabl6S f ° r Which index tables have been cre ated This table 

S ,ab ' e namS ' and the '' eW — »» ujTo 
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Table Name 

Index Table Name 

Key Fields 

Abstracts 

iabstracts 

Collection ! D, Object ID 

Admin_Defs 

iadmindefs 

Name 

Applications 

iapplications 

AppType, Name 

AppFormats 

iapp_formats 

Name, Format 

Authors 

iauthors 

Collection ID, Object ID 

ClassFields 

iclassfields 

ClassID, SeqNum 

EnumTypes 

ienumjypes 

EnumJD 

Enum_Values 

ienum_values 

EnumJD, Seq_Num 

History 

ihistory 

Acct_Date, Action 

Keywords 

ikeywords 

CollectionJD, Object_ID, Keyword 

Librarians 

ilibrarians 

UserJD, CollectionJD 

Links 

ilinks 

CollectionJD, Object JD, Name 

LongEnum 

ilong_enum 

CollectionJD, ObjectJD, Name 

Master 

imaster 

CollectionJD 

Master 

imaster2 

, Node_Type, CollectionJD 

Notify 

inotify 

UserJD 

ObjectClasses 

iobjectclasses 

ClassID 

Objects 

iobjects 

CollectionJD, ObjectJD, Class ID 

Objects 

iobjects2 

ClassJD, CollectionJD, ObjectJD 

Objects 

iobjects3 

Node_Type, ClassJD, CollectionJD, 
ObjectJD 

Preabstracts 

ipreabstracts 

CollectionJD, Object ID 


Table 1.6-1 Index Tables 


19 



1.7 Schema Hierarchy 


The NELS 1.2 schema hierarchy is illustrated by Figure 1-1 NELS Table Hierarchy. 



2 ( 












1 .8 NELS Table Relationships 

This section discusses the relationships of the tables to other tables in regards to 
their use by NELS. Each table in the hierarchy of Figure 1 .7-1 above is discussed in 
greater detail in the following paragraphs. The use of each specific field for eac 
table will not be discussed at this time. 

1.8.1 Access Privileges 

The librarians table contains the necessary information required by NELS to validate 
whether the current user has privileges to perform various NELS administrative 
functions. Every NELS library must have a minimum of one "Head Librarian . This 
person has full authorization to add, update, modify, and delete object classes 
collections, tools, and objects in the library. The "Head Librarian" is assigned a 
privileges from collection "S" and all subordinate level collections. The ’userjd and 
’subjectjd' fields are used to determine the current user privileges. Without this 
table, no other table in the library can be modified. 

1.8.2 Collections 

A collection consists of a defined area in the library (masters table), the tools 
associated with the collection (tools table), and the objects associated with the 
collection (objects table and subordinate tables). The masters tables contains the 
information about all collections in the library. 

When a librarian performs an administrative function on a collection, the tables 
below this table may be affected. Depending on the function being performed, 
different tables may be modified. If a new collection is being added or modified in 
the library, only the masters table is changed by the function. However, if a move or 
delete function is performed, the 'subjectjd' value would be used to move/remove 
all entries from the tools, members, and associated objects tables having that 
collection value All subordinate collections would also be moved/removed. 
Additionally, any librarians that were defined for any of these collections would be 
modified/deleted from the librarians table. 



Once collections have been created, tools and objects may be entered into t e 
library. When tools are added to a collection, the information about the tool is 
entered into the 'tools’ table and the 'objects' table. When objects are entered into a 
library collection, the 'members’ table and the 'objects’ tables are changed. o e 
that objects that are entered into the library also depend on information contained in 
the ’objectclasses' table and subordinate tables. The objectclasses table hierarchy 
determines what information is to be entered for the object based upon the object 
class that has been selected for that object. This is the typejd’ field in the objects 

table. 

The 'objects’ table is the primary table used in defining the metadata about an object 
entered into the library. The 'objects’ table is composed of the "objects table and 6 
subordinate tables. The six other tables which complete the definition of a object s 
metadata are the 'authors', ’abstracts’, 'preabstracts', 'keywords', 'long enum , and 
'links’ table All of these tables use the 'objectjd' field to uniquely identify the values 
associated with a particular object. However, the keywords table, uses the 
subject id and objectjd fields to uniquely identify the keywords for a particular 
object. This use of subjectjd (collection id), provides the addition of collection 
specific keywords, since an object can be used in more than one collection. 

1-8.3 ObiectClasses 

Object classes must be defined by librarians before an object of this class can be 
entered into the library. To define an object class, the hierarchy relationship 
depicted by Figure 1.7-1 is used. The objectclasses table contains basic 
information about the object class being defined. Each object class is given a 
unique identifier, 'class Jd’ field, which can be used to obtain information about all 
the field attributes associated with an object class. This value is entered into the 
’type id’ field of the objects table when a new object is added to the library. 

The classfields table contains all the field attributes which make up this object class^ 
When field attributes are inherited from another base class, the field attributes o. 
this class plus the field attributes of the base class are used to complete the object 
class definition. For example, "TGI" would require all the field attributes of object 
class "T" (the generic class) plus all the field attributes of TGI Note, all objec. 
classes other than the generic class "T”, contain two characters. 

If an attribute field in the classfields table is an enumeration type field, then 
information about the enumeration type can be found by using the 'enum id' foreign 

key field. The 'enumjypes' and 'Enum Values' tables provide information about 

the definition of the enumeration type and the enumeration values 



Appendix A SQL for NELS 1 .2 Tables 


r Create tables for NELS 7 


CREATE TABLE Abstracts 

( 


Collection! D 

CHARACTERS) 


ObjectJD 

NUMBER, 


Abstract 

LONG 

); 

CREATE TABLE Output_Queue ( 


UserlD 

CHAR(35) 

NOT NULL, 

Directory 

CHAR(80) 

NOT NULL, 

Command 

CHAR(240) 

NOT NULL); 

CREATE TABLE Authors 

( 


Collect ionlD 

CHARACTER(22) 


ObjectJD 

NUMBER 

NOT NULL. 

Author 

CHAR(240) 

NOT NULL); 

CREATE TABLE Enunv Values ( 


EnumJD 

NUMBER 

NOT NULL, 

Seq_Num 

NUMBER 

NOT NULL, 

); 

Value 

CHAR(40) 

CREATE TABLE Enumjypes 

( 


Enum ID 

NUMBER 

NOT NULL, 

Enum_Type 

CHAR(40) 

NOT NULL. 

Name 

CHAR(50) 

NOT NULL); 

CREATE TABLE History ( 

User ID 

CHAR(35) 

NOT NULL, 

Action 

NUMBER(3) 

NOT NULL, 

Acct_Date 

DATE, 

Collect ionJD 

CHAR(22), 


ObjectJD 

NUMBER 

); 

CREATE TABLE Keywords 

( 


Collection! D 

CHAR(22), 


ObjectJD 

NUMBER, 


Keyword 

CHAR(35) 

); 

CREATE TABLE Links ( 

Collection! D 

CHAR(22) 

NOT NULL, 

ObjectJD 

NUMBER 

NOT NULL. 

Name 

CHAR(50), 

LinkCollection 

CHAR(22), 


LinkObject 

CHAR(1 5) 

): 

CREATE TABLE Long Enum 

( 


Collection! D 

CHARACTER(22) 
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ObjectJD 

NUMBER 

NOT NULL, 

Name 

CHAR(50), 

NOT NULL); 

Abstract 

CHAR(240) 

CREATE TABLE Master ( 

Collect ion_ID 

CHAR(22) 

NOT NULL. 

Collect ionName 

CHAR(35) 

NOT NULL, 

Description 

CHAR(240), 


Related_Count 

NUMBER, 

NOT NULL, 

Node_Type 

CHAR(40) 

Password 

CHAR(8), 


Total_Objects 

NUMBER, 


Num_Production 

NUMBER, 


Num_Developmental 

NUMBER, 


Num_Secure 

NUMBER, 


Num_Archive_Production 

NUMBER, 


Num_Archive_Developmental 

NUMBER, 


Num_Archive_Secu re 

NUMBER 

); 

CREATE TABLE Notify ( 

User_ID 

CHAR(35), 


Object_ID 

NUMBER, 


Notifier 

CHAR(1), 


New_Vers_ID 

CHAR(40), 


Message 

CHAR(240), 


RetainDate 

DATE, 


From_User 

CHAR(35), 


Time 

DATE 

); 

CREATE TABLE Objects 

( 

NOT NULL, 

CollectionJD 

CHAR(22) 

Object_ID 

NUMBER 

NOT NULL, 

Class _ID 

CHAR(22) 

NOT NULL, 

Host_Name 

CHAR(80), 

NOT NULL, 

Format 

CHAR(40) 

Object_Name 

CHAR(80), 


PathName 

CHAR(240), 


Version 

CHAR(40), 


Lib_Entry_Date 

DATE, 


Last_Moidified 

DATE, 


Flags 

NUMBER, 


Node Type 

CHAR(40), 


Title 

CHAR(80), 


FIELD9 

CHAR(80), 


FIELD10 

CHAR(80), 


FIELD11 

CHAR(80), 


FIELD12 

CHAR(80), 


FIELD13 

CHAR(80), 


FIELD14 

CHAR(80), 


FIELD15 

CHAR(80), 


FIELD16 

CHAR(80), 


FIELD17 

CHAR(80), 


FIELD18 

CHAR(80), 


FIELD19 

CHAR(80), 
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FIELD20 

CHAR(80), 

FIELD21 

CHAR(80), 

FIELD22 

CHAR(80), 

FIELD23 

CHAR(80), 

FIELD24 

CHAR(80), 

FIELD25 

CHAR(80), 

FIELD26 

CHAR(80), 

FIELD27 

CHAR(80), 

FIELD28 

CHAR(80), 

FIELD29 

CHAR(80), 

FIELD30 

CHAR(80), 

FIELD31 

CHAR(80), 

FIELD32 

CHAR(80), 

FIELD33 

CHAR(80), 

FIELD34 

CHAR(80), 

FIELD35 

CHAR(80), 

FIELD36 

CHAR(80), 

FIELD37 

CHAR(80), 

FIELD38 

CHAR(80), 

FIELD39 

CHAR(80), 

FIELD40 

CHAR(80), 

FIELD41 

CHAR(80), 

FIELD42 

CHAR(80), 

FIELD43 

CHAR(80), 

FIELD44 

CHAR(80), 

FIELD45 

CHAR(80), 

FIELD46 

CHAR(80), 

FIELD47 

CHAR(80), 

FIELD48 

CHAR(80), 

FIELD49 

CHAR(80), 

FIELD50 

CHAR(80) 

CREATE TABLE Preabstracts ( 

Collection! D 

CHAR(22) 

ObjectJD 

NUMBER 

Keywords 

CHAR(80) 

CREATE TABLE Librarians 

( 

UserJD 

CHAR(35), 

Collection! D 

CHAR(22), 

Admin_Mask 

NUMBER(38), 

Custom_Mask 

NUMBER(38) 


CREATE TABLE ClassFields 
ClassID 
Name 
Prompt 
Kind 
Visibility 
Editable 
Length 

NumColumns 

NumLines 

FieldUnique 


( 

CHAR(22) 

CHAR(50) 

CHAR(50) 

NUMBER(38) 

NUMBER(38) 

NUMBER(38) 

NUMBER(38), 

NL)MBER(38), 

NUMBER(38), 

CHAR(1 ), 


); 


NOT NULL, 
NOT NULL, 
); 


); 


NOT NULL, 
NOT NULL, 
NOT NULL, 
NOT NULL, 
NOT NULL, 
NOT NULL, 
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SeqNum 

NUMBER(38), 


Enum_ID 

NUMBER 

); 

CREATE TABLE ObjectClasses ( 

NOT NULL, 

ClassID 

CHAR(22) 

ClassName 

CHAR(80) 

NOT NULL, 

NumFields 

NUMBER(38) 

); 

CREATE TABLE Applications 

( 


Name 

CHAR(40), 


Description 

CHAR(80), 


AppType 

CHAR(20), 


Process 

CHAR(20), 


Path 

CHAR(80), 


User_Mode 

CHAR(5), 


Parameters 

CHAR(240) 


CREATE TABLE App_Formats 

( 


Name 

CHAR(40), 


AppType 

CHAR(20), 


User_Mode 

CHAR(5), 


Format 

CHAR(40) 

); 

CREATE TABLE Admin_Defs 

( 


Name 

CHAR(35), 


Mask 

NUMBER(38) 

): 

CREATE TABLE Output_Queue ( 

NOT NULL, 

Userid 

CHAR(35) 

Directory 

CHAR(80), 

NOT NULL); 

Command 

CHAR(240) 


r Create a sequence number that will be used for object IDs 7 
CREATE SEQUENCE NewObjectID INCREMENT BY 1 START WITH 101 
NOMAXVALUE MINVALUE 100 NOCYCLE CACHE 50 ORDER; 

COMMIT WORK; 

QUIT; 
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Appendix B SQL for NELS 1.2 Table Indices 


/* Create index files for NELS tables 7 

CREATE UNIQUE INDEX iabstracts ON Abstracts(Collection_ID, ObjectJD); 

CREATE UNIQUE INDEX iadmin_defs ON Admin_Defs(Name); 

CREATE UNIQUE INDEX (applications ON Applications(Apptype, Name); 

CREATE UNIQUE INDEX iappjormats ON App_Formats(Name, Format); 

CREATE INDEX iauthors ON Authors(Collection_ID, ObjectJD); 

CREATE UNIQUE INDEX iclassfields ON ClassFields(ClasslD, SeqNum); 

CREATE UNIQUE INDEX ienumjypes ON EnumJTypes(EnumJD); 

CREATE UNIQUE INDEX ienum__values ON Enum_Values(EnumJD, Seq_Num); 

CREATE UNIQUE INDEX ihistory ON History(Acct_Date, Action); 

CREATE UNIQUE INDEX ikeywords ON Keywords(CollectionJD, ObjectJD, Keyword); 

CREATE UNIQUE INDEX ilibrarians ON Librarians(UserJD, CollectionJD); 

CREATE INDEX ilinks ON links(CollectionJD, ObjectJD, Name); 

CREATE UNIQUE INDEX ilong_enum ON Long_Enum(CollectionJD, ObjectJD, Name); 

CREATE UNIQUE INDEX imaster ON Master(CollectionJD); 

CREATE UNIQUE INDEX imaster2 ON Master(Node_Type, CollectionJD); 

CREATE UNIQUE INDEX inotify ON Notify(UserJD, Time); 

CREATE UNIQUE INDEX iobjectclasses ON ObjectClasses(ClasslD); 

CREATE UNIQUE INDEX iobjects ON Objects(CollectionJD, ObjectJD, Class_ID); 

CREATE UNIQUE INDEX iobject2 ON Objects(Object_ID, ClassJD, CollectionJD); 

CREATE UNIQUE INDEX iobjects3 ON Ob|ects(Node_Type, ClassJD, CollectionJD, ObjectJD); 

CREATE INDEX ipreabstracts ON Preabstracts(ObjectJD, CollectionJD); 

COMMIT WORK, 

QUIT; 
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